Skip to content

docs: correct categoryLinkSource supported values#1447

Merged
sserrata merged 2 commits into
mainfrom
docs/categoryLinkSource-1229
May 4, 2026
Merged

docs: correct categoryLinkSource supported values#1447
sserrata merged 2 commits into
mainfrom
docs/categoryLinkSource-1229

Conversation

@sserrata
Copy link
Copy Markdown
Member

@sserrata sserrata commented May 4, 2026

Summary

  • Removes the unsupported none value from the categoryLinkSource docs (Joi rejects it as invalid).
  • Documents the auto value, which sets the link config to generated-index (added in Breaking: Default categoryLinkSource to none, add auto option #495).
  • Corrects the tag description — it now produces a doc-type link to the generated tag index page, not generated-index.
  • Notes that omitting the option produces the implicit "no link config" behavior that none previously denoted.

Fixes #1229

Test plan

  • Verified the type union in `packages/docusaurus-plugin-openapi-docs/src/types.d.ts` (`"info" | "tag" | "auto"`).
  • Verified the Joi validator in `packages/docusaurus-plugin-openapi-docs/src/options.ts` (`valid("tag", "info", "auto")`).
  • Verified the branch logic in `packages/docusaurus-plugin-openapi-docs/src/sidebars/index.ts`.

🤖 Generated with Claude Code

sserrata and others added 2 commits May 4, 2026 14:58
Remove the unsupported `none` value, document `auto`, and correct the
description of `tag` to reflect the current `doc`-type link behavior.
Note that omitting the option produces the implicit "no link config"
behavior that `none` previously denoted (PR #495).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Apply the same correction to the demo site's options table so the
hosted docs match the package READMEs.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@sserrata sserrata merged commit 4f556c9 into main May 4, 2026
3 checks passed
@sserrata sserrata deleted the docs/categoryLinkSource-1229 branch May 4, 2026 18:59
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 4, 2026

Size Change: 0 B

Total Size: 2.26 MB

ℹ️ View Unchanged
Filename Size
demo/.docusaurus/codeTranslations.json 2 B
demo/.docusaurus/docusaurus.config.mjs 16.3 kB
demo/.docusaurus/globalData.json 69.6 kB
demo/.docusaurus/i18n.json 372 B
demo/.docusaurus/registry.js 101 kB
demo/.docusaurus/routes.js 95.2 kB
demo/.docusaurus/routesChunkNames.json 39.5 kB
demo/.docusaurus/site-metadata.json 1.58 kB
demo/build/assets/css/styles.********.css 171 kB
demo/build/assets/js/main.********.js 665 kB
demo/build/assets/js/runtime~main.********.js 23.3 kB
demo/build/index.html 95.4 kB
demo/build/petstore/add-pet/index.html 30 kB
demo/build/petstore/create-user/index.html 24.7 kB
demo/build/petstore/create-users-with-array-input/index.html 24.8 kB
demo/build/petstore/create-users-with-list-input/index.html 24.8 kB
demo/build/petstore/delete-order/index.html 24.5 kB
demo/build/petstore/delete-pet/index.html 24.8 kB
demo/build/petstore/delete-user/index.html 25 kB
demo/build/petstore/find-pets-by-status/index.html 25.5 kB
demo/build/petstore/find-pets-by-tags/index.html 26.1 kB
demo/build/petstore/get-inventory/index.html 23.8 kB
demo/build/petstore/get-order-by-id/index.html 24.8 kB
demo/build/petstore/get-pet-by-id/index.html 25.6 kB
demo/build/petstore/get-user-by-name/index.html 25.1 kB
demo/build/petstore/login-user/index.html 25.6 kB
demo/build/petstore/logout-user/index.html 24.4 kB
demo/build/petstore/new-pet/index.html 25 kB
demo/build/petstore/pet/index.html 23.2 kB
demo/build/petstore/place-order/index.html 24 kB
demo/build/petstore/schemas/apiresponse/index.html 25.2 kB
demo/build/petstore/schemas/cat/index.html 39 kB
demo/build/petstore/schemas/category/index.html 26.3 kB
demo/build/petstore/schemas/dog/index.html 39.3 kB
demo/build/petstore/schemas/honeybee/index.html 39.3 kB
demo/build/petstore/schemas/id/index.html 23.4 kB
demo/build/petstore/schemas/order/index.html 27.3 kB
demo/build/petstore/schemas/pet/index.html 38.8 kB
demo/build/petstore/schemas/tag/index.html 24.7 kB
demo/build/petstore/schemas/user/index.html 40.7 kB
demo/build/petstore/store/index.html 22.2 kB
demo/build/petstore/subscribe-to-the-store-events/index.html 30.9 kB
demo/build/petstore/swagger-petstore-yaml/index.html 30.9 kB
demo/build/petstore/update-pet-with-form/index.html 25 kB
demo/build/petstore/update-pet/index.html 25.4 kB
demo/build/petstore/update-user/index.html 25 kB
demo/build/petstore/upload-file/index.html 24.8 kB
demo/build/petstore/user/index.html 22.9 kB

compressed-size-action

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 4, 2026

Visit the preview URL for this PR (updated for commit 8337b8f):

https://docusaurus-openapi-36b86--pr1447-t4i8z4km.web.app

(expires Mon, 11 May 2026 19:04:02 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: bf293780ee827f578864d92193b8c2866acd459f

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

categoryLinkSource doesn't support 'none' value.

1 participant